home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / DiceSource / doc / dcpp.doc < prev    next >
Text File  |  1994-02-13  |  3KB  |  123 lines
  1.  
  2. dcpp/dcpp                                dcpp/dcpp
  3.  
  4.                  DCPP.DOC
  5.  
  6.                   C PREPROCESSOR
  7.  
  8.  
  9.                   Matthew Dillon
  10.                   891 Regal Rd.
  11.                   Berkeley, Ca. 94708
  12.                   USA
  13.  
  14.                   email: uunet.uu.net!overload!dillon
  15.                   email: dillon@overload.Berkeley.CA.US
  16.                   bix: mdillon
  17.  
  18.  
  19.  
  20.     dcpp sourcefile [-o outfile] [-I includedir ...] <options>
  21.  
  22.     DCPP automatically scans DINCLUDE:, DINCLUDE:PD/, and DINCLUDE:AMIGA/ .
  23.     Any -I option directories are searched in sequence BEFORE DCPP's
  24.     default search path.  The last default directory, DINCLUDE:AMIGA/, may
  25.     be modified with the -1.x and -2.x options, see below.
  26.  
  27.     Note that DINCLUDE:PD/ (added after version *.11) is meant to be a
  28.     place to put public domain header files so as not to clutter the
  29.     top level DINCLUDE: directory.
  30.  
  31.     As with all DCC commands, the space between the option and an
  32.     associated file/dir argument is optional.
  33.  
  34.     DCPP probably does not implement everything perfectly and might fail on
  35.     some constructions.
  36.  
  37.     DCC normally runs DCPP before DC1
  38.  
  39.                 CPP.DOC
  40.  
  41.     The following symbols are defined by default
  42.  
  43.     mc68000         -running on a 68000
  44.  
  45.     _DCC            -'DCC' compiler
  46.  
  47.     __STDC__        -ANSI __STDC__
  48.  
  49.     AMIGA            -AMIGA computer
  50.  
  51.  
  52.                Options to CPP
  53.  
  54.     -1.N
  55.     -2.N
  56.         This option selects the OS.  If not specified, DCPP searches
  57.         dinclude:amiga for amiga includes.    If specified, DCPP searches
  58.         dinclude:amiga1N or dinclude:amiga2N for amiga includes
  59.         instead.
  60.  
  61.         DCC supports this option and passes it along to dcpp.  This
  62.         allows developers to compile under either 1.3 or 2.0 (or
  63.         whatever) with the flick of an option.  DCC also uses a
  64.         different amiga.lib (see DCC docs).
  65.  
  66.     -d[#]
  67.         This option turns on DCPP debugging
  68.  
  69.     -o[ ]file
  70.         This option sets the output file, otherwise stdout is used.
  71.         the space is optional
  72.  
  73.     -ffp
  74.         Passed from DCC, tells preprocessor to define _FFP_FLOAT.
  75.         If not specified, preprocessor defines _SP_FLOAT.  This
  76.         exists to better support alternate floating point models
  77.         in header files.
  78.  
  79.     -D[ ]define[=stuff]
  80.         This option predefines a symbol or macro.
  81.  
  82.     -E file
  83.         specify stderr file, any errors are appended to the file
  84.         instead of to stdout.  Useful for batch compiles
  85.  
  86.     -U
  87.         This option undefines the following symbols:
  88.  
  89.         __STDC__
  90.         mc68000
  91.         _DCC
  92.         AMIGA
  93.  
  94.     -H<precompoutfile>=<headerfile>
  95.  
  96.     Enable use/creation of precompiled header files.  Example:
  97.  
  98.     -Ht:defs.m=defs.h
  99.  
  100.     see DCC.DOC for more information.
  101.  
  102.     -I0
  103.         This option causes DCPP to *NOT* include any default
  104.         directories in the include search list.
  105.  
  106.     -I[ ]dir
  107.         This option adds the specified directory to the include search
  108.         list.  A hanging slash on the end of the path is not required.
  109.         The space is optional.
  110.  
  111.     -//
  112.         Enable C++ style // comments.  The remainder of the line after
  113.         // is encountered is interpreted as a comment.  This differs
  114.         from /* style commenting in that no explicit comment-terminator
  115.         is required.
  116.  
  117.     -notri
  118.         Disable tri-graph scan pass.  Note that the tri-graph pass is
  119.         implemented in assembly and does not slow down preprocessing in
  120.         any noticable fashion, you should not disable tri-graphs unless
  121.         you need to.
  122.  
  123.